home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / unattended-upgrades / README < prev   
Encoding:
Text File  |  2008-10-13  |  3.3 KB  |  99 lines
  1. Unattended upgrades
  2. -------------------
  3.  
  4. This script can install security upgrades automatically and
  5. unattended. It will not install packages that require dependencies
  6. that can't be fetched from security and it will check for conffile
  7. prompts before the install and holds back the package that creates
  8. them. 
  9.  
  10. == Setup ==
  11.  
  12. The unattended-upgrades package will *not* act unless it is enabled
  13. explicitly.  To activate this script you need to ensure that the apt
  14. configuration contains the following lines:
  15.  
  16. APT::Periodic::Update-Package-Lists "1";
  17. APT::Periodic::Unattended-Upgrade "1";
  18.  
  19. This means that it will check for upates every day and install them
  20. (if that is possible). If you have update-notifier installed, it will
  21. setup /etc/apt/apt.conf.d/10periodic. Just edit this file then to fit
  22. your needs. If you do not have this file, just create it or
  23. create/edit /etc/apt/apt.conf - you can check your configuration by
  24. running "apt-config dump".
  25.  
  26. == Options ==
  27.  
  28. By default it will only install from the the (Ubuntu, intrepid-security)
  29. repository. This can be changed with the
  30. "Unattended-Upgrade::Allowed-Origins" apt configuration list.  It can
  31. be configured to allow any (origin, archive) combination. Those values
  32. are taken from the "Release" file on the archive server. It is
  33. recommended to use the default (only security updates from Ubuntu).
  34.  
  35. All operations will be logged in /var/log/unattended-upgrades/. This
  36. includes the dpkg output as well.
  37.  
  38. See https://wiki.ubuntu.com/AutomaticUpdates for more details about
  39. this feature.
  40.  
  41. The following configuration options are supported via the standard 
  42. apt configuration: 
  43. "APT::UnattendedUpgrades::LogDir"
  44. "APT::UnattendedUpgrades::LogFile"
  45. "Unattended-Upgrade::Allowed-Origins"
  46. "Unattended-Upgrade::Package-Blacklist"
  47. "Unattended-Upgrade::Mail"
  48.  
  49. See https://wiki.ubuntu.com/AutomaticUpdates for more details about
  50. this feature.
  51.  
  52. If you use the mail feature, make sure that /usr/bin/mail is available
  53. and working (usually the mailx package is required).
  54.  
  55. == Debugging ==
  56.  
  57. If something goes wrong or if you want to report a bug about the way
  58. the script works its a good idea to run:
  59. $ sudo o unattended-upgrade --debug
  60.  
  61. and look at the resulting logfile in:
  62. /var/log/unattended-upgrades/unattended-upgrades.log 
  63. then. It will contain additional debug information.
  64.  
  65. == Config example ==
  66.  
  67. A example configuration that will install from the
  68. intrepid-security and intrepid-updates repositories daily:
  69.  
  70. ------------------------------8<--------------------------------------
  71. // Automaticall upgrade packages from these (origin, archive) pairs
  72. Unattended-Upgrade::Allowed-Origins {
  73.     "Ubuntu intrepid-security";
  74.     "Ubuntu intrepid-updates";
  75. };
  76.  
  77. // List of packages to not update
  78. Unattended-Upgrade::Package-Blacklist {
  79. //    "vim";
  80.     "libc6";
  81.     "libc6-dev";
  82.     "libc6-i686";
  83. };
  84.  
  85. // Send email to this address for problems or packages upgrades
  86. // If empty or unset then no email is sent
  87. //Unattended-Upgrade::Mail "root@localhost";
  88.  
  89. // These APT::Periodic settings mean that each day the /etc/cron.daily/apt 
  90. // cron job will the update package list, download packages and then run 
  91. // unattended-grade to install them. 
  92. // Lock/Stamp files are in /var/lib/apt/periodic/
  93. APT::Periodic::Update-Package-Lists "1";
  94. APT::Periodic::Download-Upgradeable-Packages "1";
  95. APT::Periodic::Unattended-Upgrade "1";
  96.  
  97. ------------------------------8<--------------------------------------
  98.  
  99.